/*
 * Copyright 2004-2005 公司名
 * 本软件及其所有拷贝的名称，与光盘上或本软件中注明的公司同在。
 * 本软件及文档享有版权，并受国家版权法及国际协约条款的保护。
 * 您不可以从本软件中去掉其版权声明；并保证为本软件的拷贝（本部或部分）* 复制版权声明。
 * 您同意制止以任何形式非法拷贝本软件及文档。
 * 版权信息参见：
 *      http://www.companyname.cn/licenses
 */

package com.companyname.common.base.math;

import java.math.BigDecimal;

public class Math4Double
{
        //默认除法运算精度
        private static final int DEF_DIV_SCALE = 10;

        private Math4Double()
        {

        }

        /**

        * 提供精确的加法运算。

        * @param v1 被加数

        * @param v2 加数

        * @return 两个参数的和

        */

        public static double add(double v1,double v2)
        {
                BigDecimal b1 = new BigDecimal(Double.toString(v1));
                BigDecimal b2 = new BigDecimal(Double.toString(v2));
                return b1.add(b2).doubleValue();
        }

        /**

        * 提供精确的减法运算。

        * @param v1 被减数

        * @param v2 减数

        * @return 两个参数的差

        */

        public static double sub(double v1,double v2)
        {
                BigDecimal b1 = new BigDecimal(Double.toString(v1));
                BigDecimal b2 = new BigDecimal(Double.toString(v2));
                return b1.subtract(b2).doubleValue();

        }

        /**

        * 提供精确的乘法运算。

        * @param v1 被乘数

        * @param v2 乘数

        * @return 两个参数的积

        */

        public static double mul(double v1,double v2)
        {
                BigDecimal b1 = new BigDecimal(Double.toString(v1));
                BigDecimal b2 = new BigDecimal(Double.toString(v2));
                return b1.multiply(b2).doubleValue();
        }

        /**

        * 提供（相对）精确的除法运算，当发生除不尽的情况时，精确到

        * 小数点以后10位，以后的数字四舍五入。

        * @param v1 被除数

        * @param v2 除数

        * @return 两个参数的商

        */

        public static double div(double v1,double v2)
        {
                return div(v1,v2,DEF_DIV_SCALE);
        }

        /**

        * 提供（相对）精确的除法运算。当发生除不尽的情况时，由scale参数指

        * 定精度，以后的数字四舍五入。

        * @param v1 被除数

        * @param v2 除数

        * @param scale 表示表示需要精确到小数点以后几位。

        * @return 两个参数的商

        */

        public static double div(double v1,double v2,int scale)
        {
                if(scale<0)
                {
                        throw new IllegalArgumentException("The scale must be a positive integer or zero");
                }
                BigDecimal b1 = new BigDecimal(Double.toString(v1));
                BigDecimal b2 = new BigDecimal(Double.toString(v2));
                return b1.divide(b2,scale,BigDecimal.ROUND_HALF_UP).doubleValue();
        }

        /**

        * 提供精确的小数位四舍五入处理。

        * @param v 需要四舍五入的数字

        * @param scale 小数点后保留几位

        * @return 四舍五入后的结果

        */
        public static double round(double v,int scale)
        {

                if(scale<0)
                {
                        throw new IllegalArgumentException("The scale must be a positive integer or zero");
                }
                BigDecimal b = new BigDecimal(Double.toString(v));
                BigDecimal one = new BigDecimal("1");
                return b.divide(one,scale,BigDecimal.ROUND_HALF_UP).doubleValue();

        }
}
